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MONGODB C# 
DRIVER CHEAT 
SHEET 


The following is a comparison between 
the MongoDB shell and C# Driver. I tried to 
focus on syntax that you might encounter 
while building out a data access object 
(such as CRUD), as opposed to a 
comprehensive List of every shell 
command. The C# driver also includes 
LINQ support, however, I choose not to 
include it since it is pretty well known. 

The C# examples assume the use of 
strictly-typed classes and Queryo 
builders wherever possible, instead 
of BsonDocuments and "magic 
strings", which don't provide much in 
terms of compiLe-time safety. Check out 
the C# Driver Documentation for more info 
on how to map classes to BsonDocuments 
using property Attributes or Class Maps . 

Please note that most of the C# examples 
are condensed down as much as possible 
for the sake of brevity. 



MongoDB Shell 


Feature 


C# Driver vi.9.2 
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v.2.6.5 



INSERT 


Basic Insert 

db . users . insert ( 

{ 

name: "Derek", 
email : 

"derek@example .com" 
} 

) 

var user = new User 
{ 

Name = "Derek", 

Email = "derek@example.com" 
}i 

db.GetCollection<User> 

("users") .Insert (user); 

Insert w/ ID 

db . users . insert ( 

{ 

_id : 10 , 
name: "Derek", 
email : 

"derek@example .com" 
} 

) 

var user = new User 
{ 

Id = 10, // [Bsonld] 
attribute applied 
Name = "Derek", 

Email = "derek@example.com" 

}; 

db.GetCollection<User> 

("users") .Insert (user); 

Insert Nested 

db . users . insert ( 

{ 

_id : 100, 
name: "Derek", 
email : 

"derek@example .com", 
address: { 

city: "Portland", 
state: "OR", 
zip: "97232" 

} 

} 

) 

var user = new User 
{ 

Id = 100, // [Bsonld] 
attribute applied 
Name = "Derek", 

Email = "derek@example.com". 
Address = new Address 
{ 

City = "Portland", 

State = "OR", 

Zip = "97232" 

} 

}; 

db.GetCollection<User> 

("users") .Insert (user); 

Bulk Insert 

db.products.insert( 

[ 

{ item: "pencil", 
qty: 5 }, 

{ item: "pen", qty: 
20 }, 

{ item: "eraser", 
qty: 25 } 

] 

) 

db.GetCollection<Product> 
("products") . Insert Batch( 
new [ ] 

{ 

new Product { Item = 
"pencil", Qty = 5 }, 

new Product { Item = 
"pen”, Qty = 20 }, 

new Product { Item = 
"eraser", Qty = 25 } 

} 

); 

Write Concern 

db . users . insert ( 

{ 

name: "Derek", 
email : 

"derek@example .com" 

var user = new User 
{ 

Name = "Derek", 

Email = "derek@example.com" 

}; 

var collection = 
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{ 

writeConcern : { 
w: "majority", 
wtimeout: 5000 

} 

} 

) 

db.GetCollection<User>(" users"); 
var result = collection . Insert ( 
user, 

new WriteConcern 
{ 

W = 

WriteConcern.WMajority.W, 
WTimeout = 

TimeSpan.FromSeconds(5) 

} 

); 


FIND & QUERY OPERATORS 

Find One 

db . users . f indOne( 
{ 

_id : 10 

} 

) 

var collection = 
db.GetCollection<User>(" users"); 
var query = Query<User> . EQ( u => 
u.Id, 10); 

User user = 

collection. FindOne(query); 

Find Nested 

db . users . f ind( 

{ 

"address . state" : 

"OR" 

} 

) 

var collection = 
db.GetCollection<User>(" users"); 
var query = Query<User> . EQ( u => 
u .Address . State, "OR"); 
MongoCursor<User> cursor = 
collection. Find (query); 

Find All 

db . users . f ind( ) 

var collection = 
db.GetCollection<User>(" users"); 
MongoCursor<User> cursor = 
collection. Find All(); 

Find Array 

db . products . f ind ( 

{ 

colors: "blue" 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

// NOTE: p. Colors is of type 
string[ ] 

var query = Query<Product > . EQ( p 
=> p. Colors, "blue"); 
MongoCursor<Product> cursor = 
collection. Find (query); 

$all 

db . products . f Ind ( 

{ 

colors: { 

$all: ["blue", 
"orange" ] 

} 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var targetColors = new[] { 
"blue", "orange" }; 
var query = Query<Product>.All(p 
=> p. Colors, targetColors); 
MongoCursor<Product> cursor = 
collection. Find (query); 

$and 

db . users . f ind( 

{ 

"name": "Derek", 
"address . state" : 

"OR" 

} 

var collection = 
db.GetCollection<User>(" users"); 
var query = Query. And( 

Query<User> . EQ( u => 
u.Name, "Derek"), 

Query<User> . EQ( u => 
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) u . Address . State , "OR") 

); 

MongoCursor<User> cursor = 
collection. Find (query); 


$or 

db . users . f ind( 

{ 

$or: [ 

{ name: "Derek" }j 
{ name: "lohn" } 

] 

} 

) 

var collection = 
db.GetCollection<User>(" users"); 
var query = Query. Or( 

Query<User> . EQ( u => 
u.Namej "Derek")j 

Query<User> . EQ( u => 
u.Namej "lohn") 

)i 

MongoCursor<User> cursor = 
collection. Find (query); 

$and / $or 

db . products . f ind ( 

{ 

type: "office " , 
$or: [ 

{ item: "pen" }j 
{ qty : 25 } 

] 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query. And( 

Query<Product> . EQ(p => 
p.Typej "office")j 
Query. Or( 

Query<Product>.EQ(p 
= > p.Iterrij "pen")j 

Query< Product > . EQ( p 
=> p.Qtyj 25) 

) 

)i 

MongoCursor<Product> cursor = 
collection. Find (query); 

$gt 

db . products . f ind ( 

{ 

qty: { $gt : 5 } 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query<Product > . GT( p 
=> p.Qtyj 5); 

MongoCursor<Product> cursor = 
collection. Find (query); 

$exists 

db . users . f ind( 

{ 

name: { $exists: 
true } 

} 

) 

var collection = 
db.GetCollection<User>(" users"); 
var query = Query<User> . Exists ( u 
=> u.Name); 

MongoCursor<User> cursor = 
collection. Find (query); 

$type 

db . products . f ind ( 

{ 

item : { $type : 2 } 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query<Product>.Type(p 
= > p.Iterrij ESsonType . St ring) ; 
MongoCursor<Product> cursor = 
collection. Find (query); 


$regex 


db . products . f ind ( 

{ 

item: { $regex: 
"er$" } 

} 


var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var regex = new 

BsonRegularExpression("er$"); 
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) var query = 

Query<Product> . Matches ( p => 
p.Item, regex); 
MongoCursor<Product> cursor = 
collection. Find (query); 


sort( ) 
skip() 
limit() 

db.products.find() .sort( 
{ 

qty: 1, 
price: -1 

} 

) .skip(2) .limit(10) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var sort = SortBy<Product> 

.Ascending(p => 

P-Qty) 

. Descending( p => 

p . Price) ; 

MongoCursor<Product> cursor = 
collection 

. FindAll( ) 

. SetSortOrder ( sort ) 

. SetSkip(2) 

.SetLimit(10); 

Field Projection 

db . products . f ind ( 
{ }, 

{ 

_id : 0, 
item: 1 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 
var fields = new 
FieldsBuilder<Product>() 
.Exclude(p => p.Id) 
.Include(p => p.Item); 
MongoCursor<Product> cursor = 
collection 

. FindAll( ) 

. Set Fields (fields ) ; 

UPDATE 

Wholesale Update 

db.products.update( 

{ 

_id : 10 

}, 

{ 

type: "office" , 
item: "pen" 
qty: 5 , 
price: 2 . 99 , 
colors: ["red", 
"green", "blue"] 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query<Product > . EQ( p 
=> p.Id, 10); 
var product = new Product 
{ 

Id = 10, // Same ID required 
in C# driver 

Type = "office". 

Item = "pen", 

Qty = 5, 

Price = 2.99, 

Colors = new[] {"red", 
"green", "blue"} 

}; 

var replacement = 

Update<Product>. Replace (product); 
collect ion. Update(query, 
replacement ) ; 

$set 

db.products.update( 

{ 

var collection = 
db.GetCollection<Product> 


id: 10 ("products"); 
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$set: { price: 0.75 

} 

} 

) 


var query = Query<Product > . EQ( p 
=> p.Id, 10); 

var set = Update<Product> .Set(p 

=> p.Pricej 0.50); 

collection . Update(queryj set); 


Multi Update 

db.products.update( 

{ 

item: "pen" 

}, 

{ 

$set: { 

colors: ]"black"j 
"blue"] 

} 

}, 

{ 

multi: true 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query<Product > . EQ( p 
= > p.Iteirij "pen"); 
var myColors = new]] { "black"j 
"blue" } 

var set = Update<Product> .Set(p 
=> p.ColorSj myColors); 
collection . Update(queryj setj 
UpdateFlags. Multi); 

$inc 

db.product.update( 

{ 

item: "pen" 

}, 

{ 

$inc: { price: 1 } 

}, 

{ 

multi: true 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query<Product > . EQ( p 

= > p.Iteirij "pen"); 

var inc = Update<Product > . Inc ( p 

=> p.Pricej 1.0); 

collection . Update(queryj inCj 

UpdateFlags. Multi); 

$push 

db.products.update( 

{ 

item: "pen" 

}, 

{ 

$push: { colors: 
"red" } 

}, 

{ 

multi: true 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query<Product > . EQ( p 

= > p.Iteirij "pen"); 

var push = Update<Product > . Push ( p 

=> p.ColorSj "red"); 

collection . Update(queryj pushj 

UpdateFlags. Multi); 


REMOVE 


Basic Remove 

db. products. remove ( 
{ 

_id : 10 

} 

) 

var collection = 
db.GetCollection<Product> 

( "products " ) ; 

var query = Query<Product > . EQ( p 

=> p.Idj 10); 

collection. Remove (query) ; 

Just One 

db . products . remove ( 
{ 

_id : 10 

var collection = 
db.GetCollection<Product> 
( "products " ) ; 
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}, 

var query = Query<Product > . EQ( p 


{ 

=> p.Id, 10); 


justOne: true. 

collection. Remove (query. 


writeConcern : { 

Remove Flags. Single, 


w : 0 

WriteConcern .Unacknowledged ) ; 


} 



} 



) 
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